home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 2: CDPD 1 / Almathera Ten on Ten - Disc 2: CDPD 1.iso / pd / 301-325 / 302 / progutils / convtab.doc < prev    next >
Text File  |  1995-03-14  |  4KB  |  106 lines
  1. ==============================================================================
  2.  
  3.         Convert Tabs                    V2.1
  4.         © J.Tyberghein                  Mon Dec 18 13:40:27 1989
  5.  
  6. ==============================================================================
  7.  
  8.  
  9.  
  10. Preface
  11. -------
  12.   With this program you can convert the tabs in a file to spaces or to tabs
  13.   of another size.
  14.   The resulting file will always have the same layout as the source file.
  15.  
  16.   This program (ConvTab V2.1) is shareware.
  17.   If you like and/or use this utility I would appreciate it very much
  18.   if you'd send me a contribution of $10 US ($15 if you want to get a new
  19.   update (when one is available)).
  20.   Please send money by international money order, EuroCheck (in Belgian
  21.   Francs (BF) !) or cash, because it's very difficult for me to cash in
  22.   other checks.
  23.   If you want an update please state your current version.
  24.   If you want to use this program for commercial purposes please write
  25.   for permission !
  26.  
  27.   If you have any suggestions or remarks you can write to (Bug reports are
  28.   welcome too)
  29.  
  30.                             Jorrit  Tyberghein
  31.                              Hepmansbossen 31
  32.                            3990 Meerhout BELGIUM
  33.  
  34.  
  35.  
  36.   WARNING:
  37.     If you want to use this utility you must have Arp 1.3 or later.
  38.     ConvTab is reexecutable so you can use it with ARes, Resident, ...
  39.     ConvTab is not reentrable, so you will get a warning from ARes or Resident
  40.     if you try to use this program twice at the same time.
  41.  
  42.  
  43.  
  44. Syntax
  45. ------
  46.  
  47.   +---------------------------------------------------------------+
  48.   | Commandline template:                                         |
  49.   |   From/a,To/a,OLDTAB/a,NEWTAB,ANSI/s,NOSTR/s:                 |
  50.   |---------------------------------------------------------------|
  51.   | Usage:                                                        |
  52.   |   ConvTab <Source> <Dest> <OldTab> [<NewTab>] [ANSI] [NOSTR]  |
  53.   +---------------------------------------------------------------+
  54.  
  55.     <Source>      : file to convert
  56.     <Dest>        : converted file
  57.     <OldTab>      : this is the original tab size
  58.     <NewTab>      : specify a new tab size if you want all spaces and tabs
  59.                     in the Source file to be converted to tabs of this
  60.                     new size (if possible). If you don't specify a new tab
  61.                     size, all tabs will be converted too spaces.
  62.     <ANSI>        : normally tabs are converted in such manner, that the
  63.                     layout of the file will look good if you 'type' it on
  64.                     the standard CLI window. In other words, Ansi escape
  65.                     codes are considered to be invisible.
  66.                     But if you have an editor (like CED) which shows full
  67.                     Ansi escape codes, you must specify this option if you
  68.                     want the layout to look good. Of course the layout of this
  69.                     resulting file will probably be faulty on the standard
  70.                     CLI window (or with programs like PPMore and More).
  71.     <NOSTR>       : when this option is given, ConvTab will make no conversion
  72.                     in strings ("..." or '...'). This can be useful if you
  73.                     want to convert sources.
  74.  
  75.  
  76.   examples:
  77.  
  78.     ConvTab source.c dest.c 3
  79.       Convert all tabs to spaces in the file 'source.c'.
  80.       The file 'dest.c' will contain no tabs. The layout will be the
  81.       same as in 'source.c' on the standard CLI window, and in some editors
  82.       if 'source.c' contained no Ansi codes.
  83.  
  84.     ConvTab source.c dest.c 3 2 ansi
  85.       Convert all tabs and spaces to new tabs (size 2).
  86.       Ansi codes are not invisible.
  87.  
  88.     ConvTab source.c prt: 3 8
  89.       Print 'source.c'. Whenever there is a tab (size 8) possible, it is
  90.       generated.
  91.  
  92.     ConvTab source.c dest.c 3 3 nostr
  93.       Convert all spaces in 'source.c' to tabs if possible. The tab size
  94.       stays the same.
  95.       Strings are not converted.
  96.  
  97.         Note that even if there are no tabs in a file, you must specify an
  98.         old tab size. If this is the case, simply specify a dummy value.
  99.  
  100.  
  101. ==============================================================================
  102.  
  103.                         End of ConvTab 2.1 document
  104.  
  105. ==============================================================================
  106.